home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1991 …esperately Seeking Seven / Desperately Seeking Seven.2mg / Dev.CD.8 / Essentials / Tools / File.Type.Notes / FTN.B3.XXXX < prev    next >
Encoding:
Text File  |  1991-05-28  |  2.4 KB  |  57 lines  |  [04] ASCII Text (0x0000)
  1. Apple II
  2. File Type Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6.  
  7. File Type:  $B3 (179)
  8. Auxiliary Type: All
  9.  
  10. Full Name:  ProDOS 16 or GS/OS Application
  11. Short Name: GS/OS Application
  12.  
  13. Revised by: Dave Lyons  March 1991
  14. Written by: Dave Lyons & Matt Deatherage    September 1989
  15.  
  16. Files of this type and auxiliary type contain application programs for the
  17. Apple IIgs.
  18.  
  19. Changes since September 1989:  Added a note about the state of the
  20. Super Hi-Res screen.
  21. _____________________________________________________________________________
  22.  
  23. Files of type $B3 contain GS/OS application programs.  These files contain
  24. program code in Object Module Format (OMF) that is loaded by the System Loader
  25. or ExpressLoad at an address and is then executed in a documented environment.
  26.  
  27. The environment and constraints for application programs are documented in
  28. GS/OS Reference; all developers creating file of type $B3 should be familiar
  29. with this material.  OMF is documented in GS/OS Reference and the APW Reference
  30. Manual.
  31.  
  32. The auxiliary type for $B3 files is now defined to indicate properties of the
  33. program contained within the file.  Other parts of the system may use this
  34. information to properly control the environment for the program:
  35.  
  36. bits 31-16  reserved must be 0
  37. bits 15-8   signature byte.  $DB means bits 7-0 are valid
  38. bits 7-3    reserved must be 0
  39. bit  2      Message Aware:
  40.             1 = uses Message Center message #1
  41.             0 = ignores Message Center message #1
  42. bit  1      Desktop Application:
  43.             1 = uses desktop tools such as (at least) QuickDraw II, Event
  44.                 Manager, Window Manager, Control Manager, and Menu Manager
  45.             0 = doesn't use desktop tools
  46. bit  0      GS/OS Aware:
  47.             1 = uses long prefixes (for example, prefix 9 instead of prefix 1)
  48.             0 = uses short prefixes (less than 63 characters)
  49.  
  50. Note:   If an application has the Desktop Application bit set, it should be
  51. prepared to get control with either the text or the Super Hi-Res screen
  52. visible.  For example, if some error prevents the application from using the
  53. desktop tools, it may be necessary to call GrafOff before the user can read
  54. error messages displayed on the text screen (although GrafOff is a QuickDraw II
  55. call, it's OK to call GrafOff even if QuickDraw II is not active).
  56.  
  57.